LEADTOOLS Image Processing (Leadtools.ImageOptimization assembly)
LEAD Technologies, Inc

OptimizeBuffer(RasterCodecs,Byte[],Int32,Int32,ImageOptimizerOptions,ImageOptimizerProgress) Method

Example 





Leadtools.ImageOptimization Namespace > ImageOptimizer Class > OptimizeBuffer Method : OptimizeBuffer(RasterCodecs,Byte[],Int32,Int32,ImageOptimizerOptions,ImageOptimizerProgress) Method
The Leadtools.Codecs.RasterCodecs object used internally in the optimization operation.
The original image buffer in memory as a System.Byte array. The image format in memory should be one of the following supported formats:
The number of bytes to offset the pointer that points to the buffer parameter" so that the data will be read starting from the "Buffer + Offset" position.
The length of the image buffer, in bytes, starting from the offset byte.
The options used in the optimization process.
Optional callback function that provides information about the progress of the optimization process.
Optimizes a supported image format buffer using the passed optimization options.
Syntax
public byte[] OptimizeBuffer( 
   RasterCodecs codecs,
   byte[] buffer,
   int offset,
   int length,
   ImageOptimizerOptions options,
   ImageOptimizerProgress progressCallback
)
'Declaration
 
Public Overloads Function OptimizeBuffer( _
   ByVal codecs As RasterCodecs, _
   ByVal buffer() As Byte, _
   ByVal offset As Integer, _
   ByVal length As Integer, _
   ByVal options As ImageOptimizerOptions, _
   ByVal progressCallback As ImageOptimizerProgress _
) As Byte()
'Usage
 
Dim instance As ImageOptimizer
Dim codecs As RasterCodecs
Dim buffer() As Byte
Dim offset As Integer
Dim length As Integer
Dim options As ImageOptimizerOptions
Dim progressCallback As ImageOptimizerProgress
Dim value() As Byte
 
value = instance.OptimizeBuffer(codecs, buffer, offset, length, options, progressCallback)
public byte[] OptimizeBuffer( 
   RasterCodecs codecs,
   byte[] buffer,
   int offset,
   int length,
   ImageOptimizerOptions options,
   ImageOptimizerProgress progressCallback
)
 function Leadtools.ImageOptimization.ImageOptimizer.OptimizeBuffer(RasterCodecs,Byte[],Int32,Int32,ImageOptimizerOptions,ImageOptimizerProgress)( 
   codecs ,
   buffer ,
   offset ,
   length ,
   options ,
   progressCallback 
)

Parameters

codecs
The Leadtools.Codecs.RasterCodecs object used internally in the optimization operation.
buffer
The original image buffer in memory as a System.Byte array. The image format in memory should be one of the following supported formats:
offset
The number of bytes to offset the pointer that points to the buffer parameter" so that the data will be read starting from the "Buffer + Offset" position.
length
The length of the image buffer, in bytes, starting from the offset byte.
options
The options used in the optimization process.
progressCallback
Optional callback function that provides information about the progress of the optimization process.

Return Value

A System.Byte array that contains the optimized image buffer in memory.
Remarks

For more information, refer to Image Optimization Using The ImageOptimizer Class.

Example
  
Public Sub TestJpegImageOptimizer()
   ' Initialize the RasterCodecs class
   Dim codecs As RasterCodecs = New RasterCodecs()

   ' The input and output location
   Dim inputFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "Cannon.jpg")
   Dim outputFolder As String = Path.Combine(LEAD_VARS.ImagesDir, "OptimizedImages")

   ' Initialize a new Optimizer object
   Dim optimizer As ImageOptimizer = New ImageOptimizer()

   ' Optimization Options
   Dim options As ImageOptimizerOptions = ImageOptimizerOptions.Default

   ' Set custom optimization options
   options.JpegQualityFactor = 255
   options.JpegColorSpace = ImageOptimizerJpegColorSpace.JpegColorSpace422

   ' Load the input file into a memory byte array
   Dim orgBuffer() As Byte = File.ReadAllBytes(inputFileName)

   ' Optimize this buffer
   Dim optBuffer() As Byte = optimizer.OptimizeBuffer(codecs, orgBuffer, 0, 0, options, AddressOf OptimizeBufferProgress)

   ' Save this image into the output folder
   ' Make sure the output folder exists
   If (Not Directory.Exists(outputFolder)) Then
      Directory.CreateDirectory(outputFolder)
   End If

   ' Get the name of the output file from the input file
   Dim outputFileName As String = Path.Combine(outputFolder, Path.GetFileName(inputFileName))

   ' Save the optimized buffer to the output file
   Using fs As FileStream = File.Create(outputFileName)
      fs.Write(optBuffer, 0, optBuffer.Length)
   End Using

   ' Compare the original image size with the optimized size
   Dim orgSize As Long = New FileInfo(inputFileName).Length
   Dim optSize As Long = New FileInfo(outputFileName).Length
   Dim percentage As Integer = CType(CType(optSize * 100.0 / orgSize, Double), Integer)

   Dim message As String = String.Format( _
      "Original image size: {0} KB{1}Optimized image size: {2} KB{1}Percentage: {3}%", _
      orgSize / 1024, Environment.NewLine, optSize / 1024, _
      100 - percentage)
   MessageBox.Show(message)

   'shutdown the RasterCodecs class.
End Sub

Public Shared Function OptimizeBufferProgress(ByVal percent As Integer) As Boolean
   'Console.WriteLine(String.Format("{0}%", percent))
   Return True
End Function

Public NotInheritable Class LEAD_VARS
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class
public void TestJpegImageOptimizer( )
   {
      // Initialize the RasterCodecs class
      RasterCodecs codecs = new RasterCodecs();

      // The input and output location
      string inputFileName = Path.Combine(LEAD_VARS.ImagesDir, "Cannon.jpg");
      string outputFolder = Path.Combine(LEAD_VARS.ImagesDir, "OptimizedImages");

      // Initialize a new Optimizer object
      ImageOptimizer optimizer = new ImageOptimizer();

      // Optimization Options
      ImageOptimizerOptions options = ImageOptimizerOptions.Default;

      // Set custom optimization options
      options.JpegQualityFactor = 255;
      options.JpegColorSpace = ImageOptimizerJpegColorSpace.JpegColorSpace422;

      // Load the input file into a memory byte array
      byte[] orgBuffer = File.ReadAllBytes(inputFileName);

      // Optimize this buffer
      byte[] optBuffer = optimizer.OptimizeBuffer(codecs, orgBuffer, 0, orgBuffer.Length, options, OptimizeBufferProgress);

      // Save this image into the output folder
      // Make sure the output folder exists
      if(!Directory.Exists(outputFolder))
         Directory.CreateDirectory(outputFolder);

      // Get the name of the output file from the input file
      string outputFileName = Path.Combine(outputFolder, Path.GetFileName(inputFileName));

      // Save the optimized buffer to the output file
      using(FileStream fs = File.Create(outputFileName))
         fs.Write(optBuffer, 0, optBuffer.Length);

      // Compare the original image size with the optimized size
      long orgSize = new FileInfo(inputFileName).Length;
      long optSize = new FileInfo(outputFileName).Length;
      int percentage = (int)((double)optSize * 100.0 / orgSize);

      string message = string.Format(
         "Original image size: {0} KB{1}Optimized image size: {2} KB{1}Percentage: {3}%",
         orgSize / 1024, Environment.NewLine, optSize / 1024,
         100 - percentage);
      MessageBox.Show(message);

      //shutdown the RasterCodecs class.
   }

   static bool OptimizeBufferProgress(int percent)
   {
      Console.WriteLine(string.Format("{0}%", percent));
      return true;
   }

static class LEAD_VARS
{
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
}
Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

ImageOptimizer Class
ImageOptimizer Members
Overload List